home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / ppr.arc / PPR.DOC next >
Text File  |  1987-09-28  |  14KB  |  661 lines
  1.  
  2.  
  3.  
  4.  
  5.                                        
  6.                                      
  7.                                      
  8.                                      
  9.                                      
  10.                                      
  11.                                      
  12.                                      
  13.                                      
  14.                                      
  15.                                      
  16.                                      
  17.                                      
  18.                                      
  19.                                      
  20.                                      
  21.                      PPR: A Programmers Print Utility
  22.                                Version 2.0
  23.                                      
  24.                       Copyright  Software Solutions
  25.                               Sept. 28, 1987
  26.                                      
  27.                                      
  28.                                      
  29.                                      
  30.                                      
  31.                                      
  32.     
  33.     PPR is  a  print  utility  for  the  IBM  Personal  Computers and
  34.     compatible  units.   Software Solutions  makes  PPR  available to
  35.     prospective users under the 'Shareware' distribution concept.  If
  36.     you find  the program of  use,  you are  encouraged  to register.
  37.     More details on registration can be found in this document.
  38.     
  39.     
  40.                             Software Solutions
  41.                               961 6th St SW
  42.                             St. Paul, MN 55112
  43.                               (612) 636-8462
  44.                                      
  45.                                      
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                      
  72.                                      
  73.                             Table of Contents
  74.     -----------------------------------------------------------------
  75.                                      
  76.     Overview .....................................................  3
  77.     Features .....................................................  3
  78.     Syntax .......................................................  4
  79.     Environment variable .........................................  6
  80.     Examples .....................................................  7
  81.     Messages .....................................................  7
  82.     License ......................................................  8
  83.     Registration .................................................  9
  84.     Technical tidbits ............................................ 10
  85.     Coming attractions in PPR .................................... 10
  86.     
  87.     
  88.     
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                             PPR Users Manual
  136.  
  137.     
  138.     
  139.     Overview
  140.     --------
  141.     
  142.     PPR is  a print utility designed  for programmers.   A good print
  143.     utility should  be flexible enough  to handle any  printing need,
  144.     yet be easy to  use and configurable  to any  situation.  PPR was
  145.     written with  these ideas in  mind.  It  has  many  print options
  146.     designed to format source code  listings,  and a translation mode
  147.     that allows non-IBM printers  to print extended ASCII  codes.  To
  148.     aid in configuration,  it reads the environment area for run-time
  149.     options.
  150.     
  151.     
  152.     Features
  153.     --------
  154.     
  155.       * Can translate Extended ASCII to printable characters.
  156.     
  157.       * Variable Tab expansion.
  158.     
  159.       * Intelligent line numbering.
  160.     
  161.       * Page headers.
  162.     
  163.       * Versatile output options.
  164.     
  165.       * Supports 80 and 132 column printers.
  166.     
  167.     
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                            Software Solutions                       3
  197.  
  198.  
  199.  
  200.  
  201.                             PPR Users Manual
  202.  
  203.     
  204.     Syntax
  205.     ------
  206.     
  207.     
  208.     Usage: PPR {options} [file-spec]
  209.     
  210.     Options are:
  211.          -n    -  Narrow (80 column) form width.
  212.          -w    -  Wide (132 column) form width.
  213.          -c    -  re-directable CONsole output.
  214.          -2    -  use lpt2: as output.
  215.          -1    -  use lpt1: as output.
  216.          -e    -  translate Extended ASCII codes.
  217.          -E    -  no translation of Extended ASCII codes.
  218.          -l    -  Line numbers printed.
  219.          -L    -  Line numbers not printed.
  220.          -p    -  Pass-thru mode.
  221.          -P    -  no Pass-thru mode.
  222.          -t[X] -  expand Tabs to X character fields.
  223.          -v    -  print Version and serial number.
  224.     
  225.     
  226.     Options may be listed individually  or in groups.   The following
  227.     formats are valid:
  228.     
  229.     PPR -n -l -2 
  230.     PPR -t4E -w
  231.     PPR -n-w-nt4
  232.     
  233.     Conflicting  options can be  entered,  the last  one of  the pair
  234.     listed will be in effect.  In the last example, -n (narrow paper)
  235.     will be in effect.   PPR has several defaults options.  These are
  236.     listed below:
  237.     
  238.          -w    -  Wide (132 column) form width.
  239.          -1    -  use lpt1: as output.
  240.          -E    -  no translation of Extended ASCII codes.
  241.          -l    -  Line numbers printed.
  242.          -P    -  no Pass-thru mode.
  243.          -t[8] -  expand Tabs to 8 character fields.
  244.     
  245.     It may seem  redundant that  default options can be  specified on
  246.     the command line.  This will be explained later.
  247.     
  248.     
  249.     -n   For use with 8.5  x 11 inch paper printing at 10 chars/inch.
  250.          This controls the line  wrap  function,  and the size of the
  251.          page banner.
  252.     
  253.     
  254.     -w   For use with 15  x 11  inch paper printing at 10 chars/inch,
  255.          or 8.5  x 11 inch paper printing at 17 chars/inch.  Like -n,
  256.          this option controls line wrap and page banner size.
  257.     
  258.     
  259.  
  260.  
  261.  
  262.                            Software Solutions                       4
  263.  
  264.  
  265.  
  266.  
  267.                             PPR Users Manual
  268.  
  269.     -c   Send output to the console through the STDOUT  device.  This
  270.          allows the data stream to be re-directed  to a non-supported
  271.          device or a text file, or piped to another DOS command.  The
  272.          PPR banner and all diagnostics  are sent to the  console via
  273.          STDERR,  so  they  will  not appear in any  re-directed data
  274.          stream.
  275.     
  276.     
  277.     -2   Send output to LPT2:.
  278.     
  279.     
  280.     -1   Send output to LPT1:.
  281.     
  282.     
  283.     -e   If  your  printer  does  not  support  IBM's  extended ASCII
  284.          character  set,   this  option  can  be  used  to  translate
  285.          characters with  an  ASCII value  greater  that  127  into a
  286.          character your  printer can handle.   Some  of  the extended
  287.          ASCII characters have no close approximation in  the regular
  288.          ASCII set, but most come out looking OK.  For example:
  289.     
  290.                              ┌────────────┐
  291.                              │ » WINNER « │
  292.                              └────────────┘
  293.                              would print as
  294.                              /------------\
  295.                              | > WINNER < |
  296.                              \------------/
  297.     
  298.     
  299.     -E   If  your printer  supports the IBM  extended ASCII character
  300.          set,  then this  option  will  allow the characters  to pass
  301.          through unchanged.
  302.     
  303.     
  304.     -l   Allows PPR to  print line  numbers in the  left margin.  The
  305.          largest line  number  allowed is  99,999.   The  numbers are
  306.          printed like this: 
  307.     
  308.          10123:This is a line from your file.
  309.          
  310.          If a line exceeds the line width you selected,  PPR is print
  311.          the line like this:
  312.          
  313.            222:This is a very long  ..... li
  314.            222+ne from your file
  315.          
  316.          
  317.     -L   Tells PPR  not to place  line numbers in the  output stream.
  318.          This allows  lines to  be  6  characters longer  before they
  319.          wrap.
  320.     
  321.     
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.                            Software Solutions                       5
  329.  
  330.  
  331.  
  332.  
  333.                             PPR Users Manual
  334.  
  335.     -p   Use mainly  with  the -e  option  when  the  source  file is
  336.          pre-formatted,  say,  a  .LST  file  created  by  MASM,  but
  337.          contains  extended  ASCII  characters  your  printer  cannot
  338.          handle.   This inhibits  PPR from  adding  any  of  its' own
  339.          formatting to the output stream.
  340.     
  341.     
  342.     -P   Allows PPR to add  it's own formatting information  into the
  343.          output stream.
  344.     
  345.     
  346.     -tX  Sets the field width for the tab character (ASCII 9).
  347.     
  348.     
  349.     -v   Prints the PPR  version  number  and  date,  along  with the
  350.          serial number of the program you are running.
  351.     
  352.     
  353.     
  354.     File-spec may be any valid DOS file name,  including drive and/or
  355.     path-name.  Wildcards are not  supported  in  the  version.  Some
  356.     valid file-specs are:
  357.     
  358.     Super.Asm
  359.     c:my.lst
  360.     \asm\new.lst
  361.     
  362.     
  363.     
  364.     
  365.     Environment variable
  366.     --------------------
  367.     
  368.     Some users will find the default options unsatisfactory for their
  369.     use.   Command line options are convenient for infrequent changes
  370.     but are burdensome  for options used  all (or most)  of the time.
  371.     With this in mind,  PPR allows the user  to place  options in the
  372.     environment space.   Normally done  at boot time  in the autoexec
  373.     batch file,  this  simplifies  PPR  use.   For  instance,  if the
  374.     printer  connected  is   80   column  machine  that  needs  ASCII
  375.     conversion, the command:
  376.     
  377.     SET PPR=ne
  378.     
  379.     will allow PPR use without  command line options.   PPR reads the
  380.     PPR variable  FIRST,  then the command line options,  so a option
  381.     can be used to  override the environment  variable.  For example,
  382.     if the printer in the above example is  set to  17  chars/inch, a
  383.     file can be printed in the wide mode with this command:
  384.     
  385.     PPR -w widestuf.txt
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                            Software Solutions                       6
  395.  
  396.  
  397.  
  398.  
  399.                             PPR Users Manual
  400.  
  401.     
  402.     
  403.     Examples
  404.     --------
  405.     Assuming the environment variable has not been set up.
  406.     
  407.     
  408.     PPR -v
  409.     --   Prints the version  number.   Because no filename was given,
  410.          the program also prints out a syntax and list of options.
  411.     
  412.     PPR test.c
  413.     --   Uses the standard defaults,  -w1ElPt8.  TEST.C goes to LPT1:
  414.          with no extended ASCII conversion,  line numbers and headers
  415.          printed, and tabs expanded to 8 characters.
  416.     
  417.     PPR -n -t4 b:new.c
  418.     --   Narrow overrides  Wide,  tabs  are  set  to  4.   B:NEW.C is
  419.          printed.
  420.     
  421.     PPR -pec \old\run.lst > \new\run.lst
  422.     --   Conversion and  pass-thru are on,  and re-directable console
  423.          output is enabled.  \OLD\RUN.LST is sent untouched (but with
  424.          extended ASCII converted) to \NEW\RUN.LST.
  425.     
  426.     
  427.     
  428.     Messages
  429.     --------
  430.     
  431.     PPR: illegal option X
  432.     --   PPR has found an  option  letter  it does not  understand in
  433.          either the command  line  or  in  the  environment variable.
  434.          This is not a fatal error.
  435.     
  436.     PPR: could not open input file
  437.     --   The file to be printed could not be found. Fatal.
  438.     
  439.     PPR: Internal ERROR, cannot continue.
  440.     --   Bad news.  Call Software Solutions.  Fatal.
  441.     
  442.     PPR version number x.x,  month day, year
  443.     Serial number : xxxxx
  444.     --   Printer when the -v option is given.
  445.     
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                            Software Solutions                       7
  461.  
  462.  
  463.  
  464.  
  465.                             PPR Users Manual
  466.  
  467.     
  468.     License
  469.     -------
  470.     
  471.     
  472.     (C)Copyright  Software Solutions 1987
  473.                   All Rights Reserved
  474.     
  475.     
  476.     Solution Systems grants you the right to use, copy and distribute
  477.     PPR for noncommercial  use,  as  long  as  all  of  the following
  478.     conditions are met:
  479.     
  480.     1) No fee is charged for use, copying, or distribution.
  481.     
  482.     2) None of the files  included in this  distribution are modified
  483.     in any way.
  484.     
  485.     By using this software, you agree to these terms.
  486.     
  487.     
  488.     
  489.     Computer  clubs and user  groups  may charge  a  nominal  fee for
  490.     expenses incurred in the distribution of PPR.   This fee must not
  491.     exceed $10.
  492.     
  493.     Site licenses are available.  Write for more information.
  494.     
  495.     
  496.     PPR is provided AS IS without any warranty, expressed or implied,
  497.     including but not limited to fitness for a particular purpose.
  498.     
  499.     
  500.     If you find PPR useful, registration has several advantages.  See
  501.     the next page for more information.
  502.     
  503.     
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                            Software Solutions                       8
  527.  
  528.  
  529.  
  530.  
  531.                             PPR Users Manual
  532.  
  533.     
  534.     Registration
  535.     ------------
  536.     
  537.     If you register a copy of PPR, this is what you get:
  538.     
  539.     1) A copy of the latest version of PPR.
  540.     
  541.     2) Source code for PPR.
  542.     
  543.     3)  One dollar for every person who registers with a  copy of PPR
  544.     with your serial number.
  545.     
  546.     
  547.     
  548.     Sound good?  Then send in a copy of the order form below!
  549.     
  550.     
  551.     
  552.     
  553.     
  554.     /---------------------------------------------------------\
  555.     |Name    ____________________________________________     |
  556.     |Street  ____________________________________________     |
  557.     |City    ____________________________________________     |
  558.     |State   __   Zip _____                                   |
  559.     |                                                         |
  560.     |Serial number on current disk (important)  #________     |
  561.     |                                                         |
  562.     | Make Checks payable to : Software Solutions             |
  563.     |                                                         |
  564.     | __  PPR on disk                              $12.00     |
  565.     | __  PPR on my disk (sent with mailer)        $ 8.00     |
  566.     |                                                         |
  567.     |     6% MN sales tax (if applic)              $_____     |
  568.     |                                                         |
  569.     |     Total                                    $_____     |
  570.     |                                                         |
  571.     \---------------------------------------------------------/
  572.     
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                            Software Solutions                       9
  593.  
  594.  
  595.  
  596.  
  597.                             PPR Users Manual
  598.  
  599.     
  600.     Technical Tidbits
  601.     -----------------
  602.     
  603.     PPR does all of its'  I/O through MS-DOS calls,  so it should run
  604.     on any MS-DOS  machine.   It has been tested on  IBM, Sperry, PCs
  605.     Limited, and Compaq.  It requires only 64k of free RAM.
  606.     
  607.     
  608.     Language used : Microsoft C v4.0
  609.     Editor used   : Brief
  610.     Machine used  : Sperry IT
  611.     
  612.     
  613.     
  614.     
  615.     
  616.     
  617.     Coming Attractions in PPR
  618.     -------------------------
  619.     
  620.        * Wildcards in the file-spec.
  621.     
  622.        * Optional highlighting of language reserved words.
  623.     
  624.        * Built-in print spooler.
  625.     
  626.     
  627.     
  628.     
  629.     
  630.     
  631.     
  632.     
  633.        
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.                            Software Solutions                      10
  659.  
  660.  
  661.